home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d20 / msgcpy11.arc / MSGCOPY.DOC < prev    next >
Text File  |  1991-10-13  |  8KB  |  182 lines
  1.                                  MSGCOPY v1.10
  2.  
  3.                      A utility for Opus v1.70 and Fido V12
  4.                                   By Frank Cox
  5.                                 FidoNet 1:140/53
  6.  
  7.  
  8.      This program is truly public  domain.  You can give  it away, you can  sell
  9. it, you can hack it, you can do whatever your little heart desires.  Also,  this
  10. program is not guaranteed to do anything other than take up space on your  disk.
  11. I have tested it here and it works for me but that doesn't necessarily mean that
  12. it will work for you.  Use it at your own risk.
  13.  
  14. SO WHAT DOES IT DO?
  15. -------------------
  16.  
  17.      MSGCOPY copies any unreceived messages that are to a user on the board into
  18. the destination area and marks them as received  in the origin area so that  the
  19. message won't be moved twice.  It will add a "* NOTE:  Reply to this message  is
  20. area # Title." where # is the area the message originated from and Title is  the
  21. title of the area to the top of the body of the message text.
  22.  
  23.      Why do you want to  do this?  The users  of my system like it because  they
  24. don't necessarily have to call in every single day and they won't miss  messages
  25. addressed to them that come through even the  most active echo areas.  I have  a
  26. read-only message area on  my system called  "Echomail Replies to Local  Users".
  27. MSGCOPY slams all unreceived echomail  addressed to local users into this  area.
  28. I have O_RENUM (the Opus message renumber/deleter program by Steve Antonoff) set
  29. to delete messages in this area that are either received or older than 45  days.
  30. In this manner, even if a user goes  away for a few weeks vacation or  whatever,
  31. all of the echomail addressed to him is still waiting on his return.
  32.  
  33.      An additional  benefit  is  that your  mail  waiting  announcement  program
  34. doesn't have to read through all of the echo message areas when you use  MSGCOPY
  35. - just your local message areas and the reply area.
  36.  
  37.      MSGCOPY will optionally read  a text file  containing names of users  whose
  38. messages you do not want to copy.  For example, other sysops will likely receive
  39. their echo mail on their own system -  if they call your system, the don't  want
  40. to have  to re-read  the same  messages  again.   MSGCOPY will  ignore  messages
  41. addressed to users whose names are specified in the text file.
  42.  
  43. HOW DO YOU USE IT?
  44. ------------------
  45.  
  46. If you run Opus, this is the command line you use with MSGCOPY:
  47.  
  48. MSGCOPY -O [-uUSER.DAT] [-sSYSMSG.DAT] [-eEXCLUDE.LST] [target] [area] [area]
  49.  
  50. Explanation:
  51.  
  52.      -O means run in Opus 1.70 mode
  53.  
  54.      [-uUSER.DAT] is the path and name of the USER.DAT file
  55.           example   -uC:\OPUS\MISC\USER.DAT
  56.  
  57.      [-sSYSMSG.DAT] is the path and name of the SYSMSG.DAT file
  58.           example   -sC:\OPUS\SYSMSG.DAT
  59.  
  60.      [-eEXCLUDE.LST] is a list of names to exclude from the search
  61.           example   -eC:\OPUS\MISC\EXCLUDE.LST
  62.  
  63. If you run Fido, this is the command line you use with MSGCOPY:
  64.  
  65. MSGCOPY -F [-uCALLER.SYS] [-sFIDO.SYS] [-eEXCLUDE.LST] [target] [area] [area]
  66. Explanation:
  67.  
  68.      -F means run in Fido V12 mode
  69.  
  70.      [-uCALLER.SYS] is the path and name of the CALLER.SYS file
  71.           example   -uC:\FIDO\MISC\CALLER.SYS
  72.  
  73.      [-sFIDO.SYS] is the path and name of the FIDO.SYS file
  74.           example   -sC:\FIDO\FIDO.SYS
  75.  
  76.      [-eEXCLUDE.LST] is a list of names to exclude from the search
  77.           example   -eC:\FIDO\MISC\EXCLUDE.LST
  78.  
  79. In all cases  (both Opus and  Fido mode),  [target] is the  number of the  reply
  80. holding area and [area] is a list of the areas to be scanned.
  81.  
  82.      If -s or -u options are not specified, the current directory is scanned for
  83. USER.DAT and/or SYSMSG.DAT if the program is in Opus mode, or for CALLER.SYS and
  84. FIDO.SYS if in Fido mode.  If no exclusion list is specified with the -e option,
  85. all names in the USER.DAT or CALLER.SYS file will be included in the search.
  86.  
  87.      You can specify as many [area]'s as you can fit onto the command line.
  88.  
  89.      The Exclude.Lst file is  a text file containing  names of users whose  echo
  90. mail you do not want to copy into  the target message area.  It might look  like
  91. this:
  92.  
  93.           Jules Verne
  94.           Jonathan Swift
  95.           Edgar Poe
  96.           Charles Dickens
  97.           Thomas Hardy
  98.           Walter Scott
  99.  
  100.      If this exclusion list was  specified, then MSGCOPY would ignore echo  mail
  101. messages addressed to any of these gentlemen.
  102.  
  103.      It should also be  noted that MSGCOPY  is designed to  work with echo  mail
  104. messages, not local messages.  Due to the  method used to read the messages,  if
  105. you use it to copy  messages from a local message  area, the "* NOTE:  Reply  to
  106. this message in area #" line will be inserted in the wrong place, one  character
  107. too far into the body of the message.
  108.  
  109. EXAMPLES:
  110. ---------
  111.  
  112.      MSGCOPY -O -EC:\Opusstuf\Exclude.Lst 2 4 5 6 7 8 10 25
  113.  
  114.      This command line will operate in Opus  mode and read an exclusion list  in
  115. the  C:\Opusstuf  directory,  read  USER.DAT  and  SYSMSG.DAT  in  the   current
  116. directory, put messages into area 2, and read through messages in areas 4, 5, 6,
  117. 7, 8, 10 and 25.
  118.  
  119.      MSGCOPY -F -SE:\Stuff\FIDO.SYS -UE:\Stuff\CALLER.SYS 2 4 5 6 7 8 10 25
  120.  
  121.      This command  line would  operate  in Fido  mode  and read  CALLER.SYS  and
  122. FIDO.SYS in  the  E:\Stuff directory,  would  not  use an  exclusion  list,  put
  123. messages into area 2, and read through messages  in areas 4, 5, 6, 7, 8, 10  and
  124. 25.
  125.  
  126.      Errorlevels returned:
  127.  
  128.           0 - No fatal errors encountered
  129.           1 - USER.DAT file not found
  130.           2 - SYSMSG.DAT file not found
  131.           3 - Target Message area not found
  132.  
  133.           4 - Operating mode (-O or -F) not specified
  134.  
  135.      Note that the  error handling  in this program  is not  exhaustive for  two
  136. reasons - the additional code would slow the  program down a bit, and I was  too
  137. lazy to write the  additional code anyway.   In other words,  if you run out  of
  138. disk space, specify a file that does exist but is in an unexpected format  (such
  139. as specifying a USER.DAT file  that is really a  SYSMSG.DAT file or running  the
  140. program in the  wrong operating mode),  or similar  stuff, you may  still get  a
  141. return errorlevel  of 0.   However,  in these  kinds of  situations, you  should
  142. receive an error message of some sort on the screen.
  143.  
  144. ACKNOWLEDGMENTS
  145. ---------------
  146.  
  147.      MSGCOPY is an implementation of an idea for Opus 1.03 originally by Derrick
  148. Cedars which was developed  further for both  Opus 1.03 and  Opus 1.10 by  Simon
  149. Giles.  Actually, after seeing the initial program written by Derrick, I sort of
  150. bugged Simon until he wrote a version that worked better.  However, alas,  Simon
  151. is no longer in the nodelist.  This made it too difficult for me to bug him  for
  152. yet another update of his program when Opus 1.70 was released.  So I had to dust
  153. off the compiler and write a new version myself.
  154.  
  155.      This  implementation  of  MSGCOPY  was  written  completely  from  scratch.
  156. Simon's implementation was written  in another language  which I don't know  too
  157. much about.  So I just started again.
  158.  
  159.      Bob Swift (1:140/24) asked me to update this program so it would also  work
  160. with Fido V12, which I did.
  161.  
  162.      I would like to thank  Bob for deciphering the  structure of the Opus  1.70
  163. SYSMSG.DAT file and Fido's  FIDO.SYS and CALLER.SYS files.   I would never  have
  164. succeeded in getting this program to work the way it does without him!
  165.  
  166.      Thanks also  to Roger  Franz  (1:100/380) for  testing  a version  of  this
  167. program prior to the release of Opus 1.70.
  168.  
  169. COMMENTS, SUGGESTIONS, BUGS??
  170. -----------------------------
  171.  
  172.      Comments or questions  can be  directed to the  author via  netmail at  the
  173. above noted FidoNet address, or the old-fashioned way (pen on paper).  My postal
  174. address is
  175.  
  176.                     Frank Cox
  177.                     P. O. Box 2694
  178.                     Kindersley, Saskatchewan
  179.                     Canada  S0L 1S0
  180.  
  181.      Enjoy!
  182.